home *** CD-ROM | disk | FTP | other *** search
/ Macwelt 1 / Macwelt DVD 1.toast / Web-Publishing / HTML-Editoren / Alpha ƒ / Help / BibTeX Help < prev    next >
Encoding:
Text File  |  2000-12-15  |  47.4 KB  |  1,353 lines
  1.  
  2. BibTeX Help
  3.  
  4.  
  5.                                            help version: 4.0
  6.                                                 created: 08/17/94 {02:18:07 pm}
  7.                                             last update: 12/15/00 {02:38:33 pm}
  8.  
  9.           Introduction
  10.  
  11.  
  12. This document describes features of Bib mode and the BibTeX menu, which
  13. were written to simplify the use and maintenance of BibTeX citation
  14. database files.
  15.  
  16. Bib mode is entered when you open a file with a '.bib' suffix, or when you
  17. select the mode explicitly from the modes menu.  In Bib mode,
  18.  
  19.  
  20.   • A BibTeX menu is added to the menubar.  Menu items summarized below.
  21.  
  22.   • Selecting Mark File in the Marks menu (M on the sidebar), will
  23.     add an index mark for the cite-key of each entry in the bib file.
  24.  
  25.     Marks are added in order of appearance in the file.  To order them
  26.     alphabetically, use the "Sort Marks --> Alphabetically" command in
  27.     the Bibtex menu.
  28.  
  29.   • Keywords in Bib files are automatically colorized.
  30.  
  31.   • Double-clicking on an abbreviation string with the command key held
  32.     down (command-double-clicking) will move the cursor to the definition
  33.     of that abbreviation.
  34.  
  35.   • Command-double-clicking on the cite-key of a crossref field will
  36.     move the cursor to the referenced entry.
  37.  
  38.  
  39. A "BibTeX Example.bib" file is available for exploring the features of the
  40. mode and menu.  You can modify this file as much as you like, reformat,
  41. experiment with completions, etc.
  42.  
  43. The most recent changes to the mode include
  44.  
  45.   • Validation is now possible for single entries or an entire file.
  46.     Validating will report missing required and "non-standard" fields.
  47.   • Duplicate cite-keys can be found in the current window and across files.
  48.   • Default entry fields can now be defined through BibTeX menu.
  49.   • The list of all recognized bibliography files can be reviewed.
  50.   • One can rapidly search for text in any field in these files.
  51.   • Added support for indices and databases through the Bibtex menu.
  52.  
  53.   • Colors can now be changed through Mode Preferences dialog.
  54.   • Comment menu items are enabled.
  55.   • Smart quotes, dots from TeX mode now available as optional preference.
  56.   • Field insertion now available as an electric completion.
  57.   • Colorization and Completion support for select LaTeX commands.
  58.   • User defined acronyms can be expanded using the Expansion key.
  59.   • Completions Tutorial is now available under "Config --> Mode Prefs".
  60.   • .bib conversion packages now available under the Conversions menu.
  61.  
  62.  
  63.     ======================================================================
  64.  
  65.  
  66. Alpha's Bib mode has been designed with three major tasks in mind.  First,
  67. the mode helps you create .bib files.  Its entry templates are completely
  68. customizable, and (by using electric completions) can generally be inserted
  69. with only three or four keystrokes.  Commonly used strings (such as
  70. addresses, publishers, etc) can be defined as Bib mode specific acronyms
  71. and expanded using Alpha's "expansion" key.  
  72.  
  73. The Navigation menu items allow you to easily move through a document, and
  74. the Marks menu and "Index This Window" menu item provide concise summaries
  75. of the entries in the current window.  The Formatting menu includes items
  76. that clean up the current window and validate entries to ensure that they
  77. include the required fields.  The Cite Key Lists menu contains some items 
  78. that help ensure that you do not have duplicate cite-keys in the file.
  79.  
  80. Second, Bib mode complements Alpha's TeX mode for inserting citation keys 
  81. from a .bib file into a LaTeX document.  By creating a bibliographic Index 
  82. or Database, citations can be entered as electric completions.  Command 
  83. double-clicking on a citation within a LaTeX document will take you to its 
  84. original entry -- opening the .bib file if necessary.
  85.  
  86. Finally, the mode allows your collection of .bib files to be used as a
  87. searchable database.  Searches can be limited to the current open window,
  88. or expanded to include all of the .bib files recognized by Alpha.  Searches
  89. can be limited to specific fields, or to entire entries.  The results of a
  90. search can be optionally appended to previous search windows, and these
  91. search windows themselves can be searched to narrow the results.  In any
  92. "Search Results" window, command double-clicking on an entry will take you
  93. to its original definition.  All searches support regular expressions as
  94. well as alpha-numeric text.
  95.  
  96.  
  97.           BibTeX menu
  98.  
  99.  
  100. Here's a description of the commands available from the BibTeX menu.  Note
  101. that the menu can be made hierarchical (for those with smaller monitors) by
  102. toggling the "Hierarchical Menu" item in the "Bib Mode Options" menu. 
  103. Otherwise some items are dynamic, only available by holding down the
  104. command key while accessing the menu.
  105.  
  106.  
  107.     BibTeX Application
  108.  
  109. Switch to the BibTeX application (launching it if necessary).
  110.  
  111.  
  112.                BibTeX File List
  113.  
  114.  
  115. This menu contains a list of all of the .bib files currently recognized by
  116. Bib mode.  Selecting any will open it in a new window.  The "BibTeX Files"
  117. menu described below allows you to set some preferences regarding how this
  118. list is built.  Note that unlike the filesets menu, this list is rebuilt
  119. every time Alpha is restarted, and should only contain files that actually
  120. exist.  (If you find yourself editing a lot of .bib files when you use 
  121. Alpha, you could make this a global menu and have access to these files 
  122. every time that Alpha is launched.)
  123.  
  124. Choosing "BibTeX File List --> Rebuild File List" will recreate the menu
  125. should you find it necessary, but unless you have deleted files during your
  126. editing session it should be accurate.  This is also the list that would be
  127. used in Index and Database creation, described in more detail below.
  128.  
  129. If the "Full Pathnames" preference is not set, then only the file names 
  130. (without their parent directories) appear in the menu and in most list-pick 
  131. dialogs.  
  132.  
  133. Tip: Holding down the "option" key while clicking on the title bar will
  134. present you with a list of all currently recognized BibTeX files, as well
  135. as all currently open windows.  Selecting any of these files or windows
  136. will bring them to the front, opening them if necessary.  In Mac OS 8.0 and
  137. above, option-clicking on the sides of the current window will present this
  138. list as well, which means that you can simply move the mouse to the far
  139. left of your screen and option or command click to pop up the menu.
  140.  
  141.     Open All Bib Files
  142.  
  143. Opens all of the files currently listed in the menu.  (It might be a good
  144. idea to "List All Files" before using this to be sure that the list is up
  145. to date.)  This can be a handy way to create an actual file set for all of
  146. your bibliographies, using the "Create fileset from open windows" option.
  147.  
  148.     Close All Bib Files
  149.  
  150. Closes all of the .bib files currently listed in the menu.  If any of these 
  151. files have unsaved changes, you will be prompted to save them first.
  152.  
  153.  
  154.                Template insertion
  155.  
  156.  
  157.     Entries
  158.  
  159. Insert a template for any of the various BibTeX bibliography entry types
  160. (as in Tex mode).  By default, only the required fields an the entry are
  161. included.
  162.  
  163. Tip: Hold down any modifier key while selecting an entry menu item to edit
  164. its default fields, or use the "Default Entry Fields --> Entry Name" menu
  165. items.
  166.  
  167. Choosing "Custom Entry" lets you pick the fields to be included from a list
  168. of all fields -- you will also be given the option to save this as a
  169. default entry, which will then appear in the menu and become available as
  170. an electric completion.  Custom entries defined using this menu item
  171. CANNOT, however, be properly validated.  See the "Adding New Entries"
  172. section below for instructions on teaching Bib mode new entries for field
  173. validation.
  174.  
  175.     Fields
  176.  
  177. Insert a template for any of the various BibTeX bibliography data fields.
  178.  
  179. Tip: Hold down any modifier key while selecting a field menu item to edit
  180. the "Add Fields" preference.
  181.  
  182. Choosing Custom Field allows you to define your own field, which can then
  183. be saved and inserted into the menu, and be made available as an electric
  184. completion.
  185.  
  186. Choosing Multiple Fields lets you pick a number of fields to be included at
  187. once.
  188.  
  189.  
  190.                Entry Navigation, etc.
  191.  
  192.  
  193.     Next Entry
  194.  
  195. Jump to the top of the next entry.
  196.  
  197.     Prev Entry
  198.  
  199. Jump to the top of the previous entry.
  200.  
  201. These items are also bound to <control>-<shift>-<arrow keys>.
  202.  
  203.     Copy Cite Key
  204.  
  205. Copy the cite key for the current entry to the clipboard.
  206.  
  207.     Select Entry
  208.  
  209. Highlight the current entry (in which the cursor sits), allowing the entry
  210. to be easily moved, copied or deleted.
  211.  
  212.  
  213.                Formatting, Validating
  214.  
  215.  
  216.     Format Entry
  217.  
  218. Reformat the current entry in a standard form, with data fields indented
  219. and aligned, and data-field delimiters made uniform.  Afterwards, Alpha
  220. jumps forward to the next entry, so you can keep hitting Ctl-Shift-L to
  221. reformat a number of entries in a row.
  222.  
  223. The format may be customized via the Mode Preferences, such as aligning
  224. equals signs, zapping empty fields, the style of braces to use ...  These
  225. items are also available as toggleable menu items in "BibTeX Mode Options."
  226.  
  227. Fields which consist solely of defined strings, valid crossrefs, and
  228. standard abbreviations (defined via the "Config --> Mode Prefs" dialog)
  229. will not be surrounded by any delimiter during reformatting.
  230.  
  231. Tip: Command double-click on any valid field to format the entire entry.
  232. This will place that entry at the top of the file, and your mouse should 
  233. now be located somewhere within the next set of fields to format the next 
  234. entry.
  235.  
  236.     Validate Entry
  237.  
  238. Evaluate the fields of the current entry to check for required fields, as
  239. well as non-standard fields.  To ignore any "non-standard" fields contained
  240. in entries, i.e. those which are neither required nor optional, toggle the
  241. "Ignore Extra Fields" preference in the BibTeX Mode Options menu.
  242.  
  243. Note that only the "default" entries defined by Bib mode have information
  244. regarding required versus optional fields.  Entries created using the
  245. "Custom Entry" menu item cannot be validated.  To teach Bib mode new
  246. entries for validation purposes, see the "Adding New Entries" section
  247. below.
  248.  
  249. Tip: Command double-click on any valid entry name to validate the entire
  250. entry.  This will place that entry at the top of the file, and your mouse
  251. should now be located somewhere near the name of the next entry to validate
  252. it.
  253.  
  254.     Format All Entries
  255.  
  256. (A dynamic menu item available by pressing the command key.)
  257.  
  258. Reformat the current entry and all subsequent entries to end of the file. 
  259. You must go to the top of the window first to truly format "all" entries. 
  260. If any entry cannot be formatted, results will be displayed in a new
  261. window.
  262.  
  263. You can interrupt this by hitting the Cmd-. key
  264.  
  265.     Validate All Entries
  266.  
  267. (A dynamic menu item available by pressing the command key.)
  268.  
  269. Evaluate the fields for current entry and all subsequent entries to end of
  270. the file, and check for duplicate cite-keys.  You must go to the top of the
  271. window first to truly validate "all" entries.  Results will be displayed in
  272. a new window if there were any missing fields, duplicate cite-keys,
  273. unrecognized entries, or (optionally) any "non-standard" fields present.
  274. Because this "results" window can get quite busy, all entries that simply
  275. have missing fields will be listed in the marks menu.
  276.  
  277. You can interrupt this by hitting the Cmd-. key
  278.  
  279.  
  280.                Searching
  281.  
  282.  
  283. Bib mode offers several different ways to search the entries contained not
  284. only in the current window but also within all of the files recognized by
  285. Alpha as .bib files.
  286.  
  287. The first three items, searching Entries, Fields, and Bib Files, will
  288. display their results in a "Search Results" window, with all unique
  289. cite-keys listed in the Marks menu.  Command double-clicking on any
  290. cite-key will jump to its original entry, opening the file if necessary. 
  291. Additional searches can be appended to any current results window, or
  292. displayed in a new one.  Results windows can be saved as files as well.
  293.  
  294. If a search of "All Bib Files" results in multiple files identified, you
  295. will be given the option to insert the results of any listed file into the
  296. results window.  Alternatively, you could list all matches in a "browser"
  297. window, from which you can jump to any given match.
  298.  
  299. Note that "Search Results" windows themselves can be searched, to narrow
  300. the selections.  (When doing so be sure to save the original window,
  301. because this will be the only one containing the names of the source
  302. files.)  Search windows can also be validated, checked for duplicate
  303. cite-keys, or the entries could be counted, or the window could be sorted
  304. and indexed ...
  305.  
  306. All of these searches can take regular expressions.
  307.  
  308.     Search Entries
  309.  
  310. Search for entries that contain a given alpha-numeric text string (i.e. no
  311. dashes or other special symbols) or a regular expression.  Search strings
  312. are not case-sensitive.
  313.  
  314. An example: Open the "BibTeX Example.bib" file.  Select "Search Entries",
  315. and enter the search string "unix".  The results will be displayed in a new
  316. window -- command double-clicking on any cite-key will send you to its
  317. original location.  Now search for the string "C\+\+" -- the backslashes
  318. are necessary because -'s and +'s are special regular expression symbols.
  319.  
  320. Tip: holding down the control key while command double-clicking on any text
  321. will start a search for that text across all fields in the current window.
  322.  
  323.     Search Fields
  324.  
  325. (A dynamic menu item available by pressing the command key.)
  326.  
  327. Search for entries in which a particular field matches alpha-numeric text
  328. (i.e. no dashes or other special symbols) or a regular expression.  Search
  329. strings are not case-sensitive.
  330.  
  331. An example: Open the "BibTeX Example.bib" file.  Select "Search Fields",
  332. and choose the "author" field.  Now enter the search string "Knuth".  The
  333. results will be displayed in a new window -- command double-clicking on any
  334. cite-key will send you to its original location.  Now search for the string
  335. "Tcl|Tk" in the "titles" field to locate all entries with either Tcl or Tk
  336. in their title.
  337.  
  338. Tip: holding down the shift key while command double-clicking on any text
  339. will start a search for that text in the field in which it is contained in
  340. the current window.
  341.  
  342.     Search All Bib Files
  343.  
  344. Search for a given string within all possible bibliographies.  This
  345. item uses the list of bibliographies specified by the "Use ...  Path"
  346. preferences available (as toggleable menu items) in the "BibTeX Files"
  347. menu.  To find out which .bib files will actually be searched, use the
  348. "BibTeX Files --> List All Bibliographies" menu item described below.  
  349. Searches can be limited to specific fields, including cite-keys, or 
  350. include the entire file (by specifying "all fields").
  351.  
  352. Unlike "Search Entries" and "Search Fields", strings are case-sensitive.
  353.  
  354. If searching for cite-keys, only a portion has to be entered, such as
  355.  
  356.     DiMagg
  357.  
  358. This search also supports of regular expressions, such as
  359.  
  360.     Marx|Engels
  361.  
  362. to locate bibliographies with citekeys including either "Marx" or "Engels". 
  363. Or one could enter
  364.  
  365.     DiMag.+198
  366.  
  367. to find all of the bibliographies with 1980's DiMaggio entries (assuming
  368. that you include the full century year in your citations.)  Or
  369.  
  370.     186[0-9]
  371.  
  372. to find all of bibliographies that contain 1860's citations.  
  373.  
  374. If only one file is identified, the results of the search will be inserted
  375. automatically into a "Search Results" window.  If multiple files were
  376. found, you will be given the option to list all of the search results in a
  377. "browser" window (from which you can open any file), or to include only the
  378. files that you specify.
  379.  
  380. You can interrupt this by hitting the Cmd-. key
  381.  
  382.     Quick Find Citation
  383.  
  384. (This is also bound to <control>-<shift>-Q for Alphatk users.)
  385.  
  386. Search the Index incrementally by cite key.  Requires that an index be
  387. created, and if none exists you will be prompted to create one (based upon
  388. the "Bib Auto Index" preference.)  The "List All Bibliographies" menu item
  389. allows you to preview the files that will be indexed.  Indices and
  390. Databases are described in more detail below.
  391.  
  392. Assuming that an index exists ...
  393.  
  394. The status bar window will prompt you for the first letter of the citation
  395. that you want to find.  After typing it, you will be presented with a list
  396. of all potential completions.  Pressing the tab key will extend the list. 
  397. At this point you could either type the number of the item in list (as in
  398. typing 2 for the second item you see presented) or press another letter to
  399. reduce the options.  Once you have narrowed the selection to a single
  400. unambiguous entry, you will jump to the citation you've chosen, opening the
  401. file in which it is contained if necessary.
  402.  
  403.  
  404.                Cite Key Lists
  405.  
  406.  
  407. This menu helps you manage lists of cite-keys in both the open window and 
  408. across multiple files.
  409.  
  410.     Count Entries
  411.  
  412. Report the total number of entries in the current window, as well the
  413. number of entries of each type.
  414.  
  415.     Find Duplicates
  416.  
  417. Searches for duplicate cite-keys in the current window.  If any duplicates 
  418. are found, results will be displayed in a new window -- command double 
  419. clicking on any cite-key will take you to its original definition.  
  420.  
  421. Following a duplicate search, the cite-keys are saved by Alpha.  If you
  422. perform subsequent duplicate cite-key searches on other windows, you will
  423. be asked if you also want to compare these cite-keys to those of the
  424. previous window.  (The file names of windows previously searched appears at
  425. the bottom of this menu.)  If so, the cite-keys of this second window will
  426. be added as well.  If not, the cite-key list will first be cleared.
  427.  
  428. Tip: Pressing the shift key while command double-clicking on any cite-key
  429. will perform a rapid search for duplicates in the current window.
  430.  
  431.     List Cite Keys
  432.  
  433. This will create a new window that contains only the citation keys and the
  434. "title" field of entries for easy scanning of the .bib files contents. 
  435. Command double-clicking on any cite-key will return you to its original
  436. entry.  Important: this is NOT the index used in "Quick Find Citation" or 
  437. for electric completions.  See the "Indices and Databases" section below.
  438.  
  439. Indexing a "Search Results" window will give you a concise list of the 
  440. entries that you have identified -- one possible use is to retrieve the 
  441. list of entries found in the Marks menu.
  442.  
  443.     Count All Entries
  444.  
  445. (A dynamic menu item available by pressing the command key.)
  446.  
  447. Report the total number of entries in multiple files specified through a 
  448. list-pick dialog.
  449.  
  450.     Find All Duplicates
  451.  
  452. (A dynamic menu item available by pressing the command key.)
  453.  
  454. This item allows you to easily compare the cite-keys of several files at 
  455. once.  After choosing a list of files, the cite-keys of each one will be 
  456. progressively added to the list and compared to those that are already 
  457. there.  Results will be displayed in a new window.
  458.  
  459. Note that in both of these menu items the term "duplicate" is an exact one
  460. -- after one match has been found, Alpha records the pair and moves on to
  461. the next cite-key.  If a cite-key appears in three different files, it will
  462. be noted as a duplicate for files 2 and 1, and then again (later in the
  463. report) for files 3 and 1.  Before searching for duplicates across files, 
  464. it is a good idea to check first for duplicates only within files.
  465.  
  466.     List All Cite Keys
  467.  
  468. (A dynamic menu item available by pressing the command key.)
  469.  
  470. Displays a list of all currently recognized cite-keys in a new window. 
  471. This can be a slower procedure.  Command double-clicking on any listed
  472. cite-key will take you to its original definition, opening the file if
  473. necessary.  If no cite key list currently exists, you will be prompted to 
  474. first create one.
  475.  
  476.     Create Cite Key List
  477.  
  478. Allows you to choose the files to include in the current cite-key list.  If
  479. you only want to compare the current window against a list of others, first
  480. create a list of the others.  (The files that are currently included in the
  481. list appear at the bottom of this menu.  Selecting any of them will create
  482. an "List Cite Keys" window using the menu item described above.)
  483.  
  484. Now select the "Find Duplicates" menu item.  When asked if you want to use 
  485. the current list, choose "yes" and the cite-keys of the current window will 
  486. be compared to the other files listed.
  487.  
  488.     Clear Cite Key List
  489.  
  490. Removes all current cite-keys from Alpha's memory.
  491.  
  492.  
  493.                Sorting, Marking
  494.  
  495.  
  496.     Sort by …
  497.     ---------
  498.  
  499. Sorts the current window by one of various criteria ...
  500.  
  501. The Overwrite Buffer preference controls whether the sorted database is
  502. written back to the original buffer or into a new one.
  503.  
  504.     Cite Key
  505.  
  506. Sorts by the citation key
  507.  
  508.     First Author, Year
  509.  
  510. Sorts by first author, and secondarily by year
  511.  
  512.     Last Author, Year
  513.  
  514. Sorts by last author, and secondarily by year
  515.  
  516.     Year, First Author
  517.  
  518. Sorts by year, and secondarily by first author
  519.  
  520.     Year, Last Author
  521.  
  522. Sorts by year, and secondarily by last author
  523.  
  524.  
  525.     Sort Marks …
  526.     ------------
  527.  
  528. Sorts the Marks either ...
  529.  
  530.     Alphabetically
  531.  
  532. Sorts the index marks on the marks menu alphabetically.
  533.  
  534.     By Position
  535.  
  536. Sorts the index marks by the position of the entry.
  537.  
  538. The {} "Parse Funcs" menu item will return only every 10th entry in the 
  539. file, useful if you want to navigate a .bib file that has several hundred 
  540. entries ...
  541.  
  542.  
  543.     Bib File Conversions
  544.     --------------------
  545.  
  546. A few conversion packages have been written for Alpha's Bib mode, to turn a
  547. .bib file into a nicely formatted .html file, etc.  See the "Conversions"
  548. section below for more information.
  549.  
  550.  
  551.                Setting Bib Mode Options
  552.  
  553.  
  554. This section contains four submenus which help you to configure Bib 
  555. mode's various preferences and behavior.
  556.  
  557.  
  558.     Default Entry Fields
  559.     --------------------
  560.  
  561. This menu contains all of the entries in the "Entries" submenu.  By
  562. default, only the required fields are included when a new bib entry is
  563. created.  You can modify this behavior by selecting any one of these
  564. entries -- a dialog box will present you with the current list.  Fields
  565. will appear in the specified order.
  566.  
  567. These changes will be saved as a mode preference, and will remain in place
  568. in future sessions of Alpha.
  569.  
  570.     Restore Default Preferences 
  571.  
  572. Allows you to restore any of the default entry preferences that you have
  573. changed.
  574.  
  575.     Remove Custom Entry …
  576.  
  577. Allows you to remove any entries defined using the "Custom Entry" menu
  578. item in the Entries menu.
  579.  
  580.     Remove Custom Field …
  581.  
  582. Presents you with the list of the "Add Fields" preference, which you can
  583. then edit.  (Additional custom fields can actually be added using this menu
  584. item.)
  585.  
  586.  
  587.     BibTeX Mode Options
  588.     -------------------
  589.  
  590. All of Bib mode's "flag" preferences can be turned on/off using the toggled
  591. menu items.  These preferences are explained in more detail below.
  592.  
  593. Tip: Hold down any modifier key while selecting a mode option menu item to
  594. obtain a brief description of the preference.
  595.  
  596.     BibTeX Mode Help
  597.  
  598. Opens this file ...
  599.  
  600.  
  601.     Bib Mode Acronyms
  602.     -----------------
  603.  
  604. Bib mode allows you to create acronyms for electric completion / expansion. 
  605. Take the "Bib Tutorial.bib" completions tutorial for more information, or
  606. see the section below on "Key Bindings and Completions".
  607.  
  608. This menu allows you to view, add, and remove the acronyms recognized by 
  609. Bib mode.  In addition, you can "unset" the list of acronym expansions 
  610. that are supplied by default.
  611.  
  612.     Check Keywords
  613.  
  614. If you are considering defining your own custom entry, field, or acronym,
  615. it might be useful to first make sure that the keyword is not already
  616. assigned in one of the mode's lists.
  617.  
  618.     Bib Mode Tutorial
  619.  
  620. Opens the "Bib Tutorial.bib" completions tutorial.
  621.  
  622.  
  623.     Bib Mode Files
  624.     --------------
  625.  
  626. This menu helps you set the behavior of Alpha regarding the creation of the
  627. "bibliography file list".  This list, which is created "on the fly" when
  628. needed by certain menu items or procedures, is used to create the indices
  629. and databases described below, and for the "Search All Bib Files" menu
  630. item.
  631.  
  632.     List All Bibliographies
  633.  
  634. Opens a dialog box, listing all of the bibliographies that would currently
  635. be used to create a database or an index.  Double-clicking on any of these
  636. files will open them in a new window.
  637.  
  638.     ________________
  639.  
  640. The next four items are toggleable preferences that help determine how this
  641. list is created.  (These are the same preferences that can be set in the
  642. "Config --> Mode Prefs" dialog.)
  643.  
  644.     Full Pathnames
  645.  
  646. Include the full pathnames in list-pick dialogs and in the "BibTeX Files" 
  647. menu.  Note that Bib mode is generally happier if no .bib files have the 
  648. same filename -- if you have both
  649.  
  650.     :paper1/myfile.bib   and
  651.     :paper2/myfile.bib
  652.  
  653. then command double-clicking in "Search Results" windows could get funky...
  654.  
  655.     Use Current Path
  656.  
  657. Look in the file folder of the current window for any valid .bib files.
  658.  
  659.     Use Open Windows
  660.  
  661. Include any open windows in the bibliography list, provided that they are
  662. valid .bib files.
  663.  
  664.     Use Search Paths
  665.  
  666. Look in folders associated with both Bib or TeX modes, as set using the
  667. "Set Search Paths" menu item.  Search paths (which are mode specific) only
  668. have to be set for Bib or TeX modes -- when listing bibliographies Bib 
  669. mode will use both.
  670.  
  671.     Use Tex Paths
  672.  
  673. Look in the Tex-inputs folder or .aux file to list all bibliographies. 
  674. This only applies if you are prompted to rebuild an index or database in a
  675. LaTeX document after failing to either complete a citation electrically, or
  676. find a citation by command double-clicking on it .
  677.  
  678. The "TeX Path" is dependent on the .aux file of the current LaTeX document,
  679. which cannot be accessed unless the "rebuild database" procedure is being
  680. called by TeX mode.  These bibliographies could be included, however, via
  681. the other preferences ...
  682.  
  683.     ________________
  684.  
  685. The last section of this submenu allow one to set the "Search Paths"
  686. specific to Bib mode.  These make use of the package: searchPaths, which
  687. allows multiple folders to be designated for any mode.  (These menu items
  688. are normally only available in the "Config --> Mode Prefs" menu, but are
  689. reproduced here for convenience.  Activating the "Search Paths" package is 
  690. not necessary.)
  691.  
  692. If the "Use Search Paths" preference is turned off, these items will be
  693. dimmed -- just a little reminder that you need to set the preference AND
  694. the search paths !
  695.  
  696.  
  697.                Indices and Databases
  698.  
  699.  
  700. The remaining items update (or create) the indices and databases used in
  701. searching for and inserting BibTeX entries.  See the section above
  702. regarding "BibTeX Files" to determine which files will be used in index or
  703. database creation.
  704.  
  705. Indices and Databases support citation completions when editing LaTeX
  706. files.  The term "database" properly suggests that this is a complete list
  707. of the citation keys which you have instructed Alpha to keep track of.
  708.  
  709. For example, open a .bib file.  Select "Add Win to Database".  This indexes
  710. all of the citation keys and titles in the current file and adds its path
  711. to the search list.  Now open a .tex file.  Type
  712.  
  713.     \cite{<something>|
  714.  
  715. where <something> is the beginning of a reference key in .bib file you
  716. just added to the citation database and attempt to complete it.  
  717.  
  718. (To find out what your completion key is, and to change it if desired, use
  719. the "Config --> Special Keys" menu item.)
  720.  
  721. If the completion hint exists within the database, you should be prompted
  722. with a list of completions (if the hint was ambiguous), or Alpha will
  723. simply insert the citation key straight from the index or database. 
  724. Command double clicking on the item will then open up the .bib file in
  725. which it is contained.  If no completion can be found, you will be
  726. presented with a list of various options -- including rebuilding the
  727. index or database.
  728.  
  729. Bib Indices and Databases are very handy !!
  730.  
  731.  
  732.     Build/Rebuild Index/Database
  733.  
  734. Builds (or rebuilds) the index/database, using the bibliographies file set
  735. by the "Use ...  Paths" preferences.  
  736.  
  737. The "bibIndex" and "bibDatabase" files are stored in your prefs folder.
  738.  
  739. IMPORTANT: An Index only contains the cite keys, while a Database also
  740. contains the titles.  TeX mode includes "Show Titles" preference that
  741. determines what appears in the list-pick dialog when your attempted
  742. completion is ambiguous -- just the citation keys (stored in a "bibIndex"
  743. file), or both the keys and the titles (stored in a "bibDatabase" file.) 
  744. The index is also used for the "Quick Find Citation" menu item.  
  745.  
  746.  
  747. Rebuilding either the index or database will remove all previous
  748. contents.  In practice, it's a good idea to rebuild both the index and
  749. the database at the same time.
  750.  
  751.     Review Index/Database
  752.  
  753. (A dynamic menu item available by pressing the command key.)
  754.  
  755. Opens the "bibIndex/Database" file located in your preferences folder.  
  756.  
  757.     Remove Index/Database
  758.  
  759. (A dynamic menu item available by pressing the control key.)
  760.  
  761. Removes the "bibIndex/Database" file located in your preferences folder.
  762.     
  763.  
  764.     Add Win To Index/Database
  765.  
  766. Adds the current open window to the bibliography index/database.  If the
  767. current window is not a .bib file, you will have the option to choose
  768. amongst all current open .bib windows.
  769.  
  770. Note that if this file had been previously added to the index/database,
  771. the old entries are not removed.  You may do so yourself (manually) by
  772. reviewing the index/database, unlocking it, and deleting the old
  773. entries.  
  774.  
  775.     Add Files To Index/Database
  776.  
  777. (A dynamic menu item available by pressing the command key.)
  778.  
  779. Opens a list-pick dialog, allowing you to select files that will be
  780. added to the bibliography index/database.  Only those files designated
  781. by the "Use...  Path" preferences are available.  
  782.  
  783. Note that if these files had been previously added to the
  784. index/database, the old entries are not removed.  You may do so yourself
  785. (manually) by reviewing the index/database, unlocking it, and deleting
  786. the old entries.
  787.  
  788.  
  789.     ======================================================================
  790.  
  791.  
  792.           Mode Preferences
  793.  
  794.  
  795. The behavior of the Bibtex menu may be controlled using by setting the
  796. various preferences through the "Config --> Mode Prefs --> Preferences"
  797. dialog.  Many of these can also be set using the "BibTeX Mode Options"
  798. menu.  The appearance of the menu itself can be controlled by setting the
  799. "Hierarchical Menu" item.  Turning it off will place the Navigation,
  800. Searching, Formatting and Database items in the main menu.  
  801.  
  802. The rest include ...
  803.  
  804.  
  805.                Completions, Electrics
  806.  
  807.  
  808.     Field Completions
  809.  
  810. Allows fields to be completed when using electric routines.
  811.  
  812.     LaTeX Completions
  813.  
  814. Allows select LaTeX commands to be completed when using electric routines.
  815.  
  816.     Smart Dots
  817.  
  818. Turns '...'  into '\ldots' automatically as you type
  819.  
  820.     Smart Quotes
  821.  
  822. Turns ' or " into ` or `` or ' or '' automatically as you type, depending
  823. upon the context.
  824.  
  825.     Unset Acronyms List
  826.  
  827. Allows you to remove the list of "default" acronyms provided by the mode. 
  828. See the section below on "Key Bindings and Completions" for more
  829. information.
  830.  
  831.  
  832.                Entry Formatting, Validating
  833.  
  834.  
  835.     Align Equals
  836.  
  837. Line up the = signs for all fields when reformatting.
  838.  
  839.     Entry Braces
  840.  
  841. Use curly braces to delimit entries (otherwise parentheses are used).
  842.  
  843.     Field Braces
  844.  
  845. Use curly braces to delimit field values (otherwise quotation marks are
  846. used).
  847.  
  848.     Fill Column
  849.  
  850. The maximum width of each line in the field value.
  851.  
  852.     Ignore Extra Fields
  853.  
  854. Only report the missing required fields when validating entries.
  855. Otherwise, all "non-standard" fields will be reported as well.
  856.  
  857.     Indent String
  858.  
  859. Define the indentation string for field names.  The default is three
  860. spaces.
  861.  
  862.     Std Abbrevs
  863.  
  864. Define standard abbreviations (which we avoid surrounding with delimiters)
  865. that do not appear in @string entries.
  866.  
  867. By default, three-letter English month names are included.
  868.  
  869.     Zap Empty Fields
  870.  
  871. Remove optional fields if they're empty.  All fields for entries defined
  872. using the "Custom Entry" menu item are considered to be optional.
  873.  
  874.  
  875.                Sorting, Marking
  876.  
  877.  
  878.     Auto Mark
  879.  
  880. Automatically mark the .bib file when it is first opened, and following any
  881. sorting routine.
  882.  
  883.     Descending Years
  884.  
  885. Sort by year in descending order (most recent to oldest).
  886.  
  887.     Mark Strings
  888.  
  889. Include @string definitions in the marks menu.
  890.  
  891.     Overwrite Buffer
  892.  
  893. Allow sorts to replace the original window contents -- otherwise they are
  894. written to a new window.
  895.  
  896.     Segregate Strings
  897.  
  898. Collect all @string definitions together at the top of the file in sorts.
  899. (Otherwise sort alphabetically)
  900.  
  901.  
  902.                BibTeX Files
  903.  
  904.  
  905. These items determine how the "bibliography list" is created, and are
  906. described above in the "Indices and Databases" section.
  907.  
  908.     Full Pathnames
  909.  
  910. Include the full pathnames, not just the tail, in menus and dialogs.
  911.  
  912.     Use Current Path
  913.  
  914. Look in the file folder of the current window for any valid .bib files.
  915.  
  916.     Use Open Windows
  917.  
  918. Include any open windows in the bibliography list, provided that they are
  919. valid .bib files.
  920.  
  921.     Use Search Paths
  922.  
  923. Look in folders associated with Bib or TeX mode, depending on the mode of
  924. the procedure which needs to create the list.
  925.  
  926.     Use Tex Paths
  927.  
  928. Look in the Tex-inputs folder or .aux file to list all bibliographies. 
  929. This only applies if you are prompted to rebuild the database while editing
  930. a LaTeX document.
  931.  
  932.     Bib Auto Index
  933.  
  934. When certain procedures determine that the Index / Database either doesn't 
  935. exist or is out of date, they will attempt to rebuild them.  This 
  936. preference allows you to be prompted before doing so.
  937.  
  938.  
  939.                Keyword Colorizing
  940.  
  941.  
  942. Colors can be defined for comments, strings, entries, and fields.  Special
  943. LaTeX symbols ($ ^ _ ~ # and &) can also be colorized, useful when they are
  944. contained in fields and must be preceded with a backslash.
  945.  
  946. Additional fields to be colorized can be included in the "Add Fields"
  947. preference.
  948.  
  949. BibTeX mode supports colorizing and keyword completion of a limited number
  950. of LaTeX commands, including all of those in the "LaTeX --> Text Style"
  951. menu item.  Additional commands can be added in the "Add TeX Commands"
  952. preference.  These will all use the Entry Color.
  953.  
  954.  
  955.     ======================================================================
  956.  
  957.  
  958.           Key Bindings, Completions
  959.  
  960.  
  961. Most of these functions (except template insertion) are also bound to
  962. keystrokes.  The standard bindings are listed in the menu -- the usual
  963. binding involves both control and shift.  Navigation menu items are also
  964. bound to <control>-<shift>-<arrow keys>.
  965.  
  966. Although the TeX-mode keybindings aren't available in Bib mode, the LaTeX
  967. menu can easily be inserted in the menubar.  This may be useful for
  968. inserting the various text-style codes that are recognized in BibTeX
  969. fields.  These are also available as electric completions -- see the 
  970. completions tutorial "Bib Tutorial.bib" for more information.
  971.  
  972. While there are no key bindings for entry template insertion (such as @book,
  973. @article,  etc), BibTeX mode has a built Electric Completion capabilities.
  974.  
  975. After typing in a portion of an entry, such as
  976.  
  977.     @art|
  978.  
  979. pressing your electric completion key will build the entry for you,
  980. including your custom fields as you have defined them, such as
  981.  
  982.     @article{|,
  983.        author =   {•},
  984.        title =    {•},
  985.        journal =  {•},
  986.        volume =   •,
  987.        number =   •,
  988.        pages =    {•},
  989.        year =     •,
  990.        abstract = {•},
  991.     }
  992.  
  993. All defined fields, including those defined by the user, as well as defined
  994. LaTeX commands can also be included in the completion routines, simply by
  995. toggling the "Field / LaTeX Completions" menu items in the BibTeX Mode
  996. Options menu.
  997.  
  998. User defined acronyms can also be completed or expanded.  For example, 
  999. after typing
  1000.  
  1001.     ad|
  1002.  
  1003. and expanding it to
  1004.  
  1005.     address = {|},
  1006.  
  1007. one could type
  1008.  
  1009.     address = {ny|},
  1010.  
  1011. and expand it to
  1012.  
  1013.     address = {New York},
  1014.  
  1015. which means that all that you actually typed was
  1016.  
  1017.     ad|ny|
  1018.  
  1019. to insert the field.  Very efficient !!  Bib mode comes with a very small
  1020. demonstration set of acronyms, contained in "BibCompletions.tcl".  The menu
  1021. item "Bib Mode Acronyms --> Add Acronyms" allows you to create your own.
  1022.  
  1023. The Completions Tutorial ("Bib Tutorial.bib") contains more information
  1024. regarding completions and expansions.  This is available via the menu item
  1025. "Bib Mode Acronyms --> Bib Mode Tutorial" menu item.
  1026.  
  1027. The "Config --> Special Keys" menu item both tells you your electric
  1028. completion key and allows you to modify it.  For more information
  1029. concerning "electric" behavior, you could consult the "Alpha Manual" or the
  1030. more advanced "ElecCompletions Help" file.
  1031.  
  1032.  
  1033.           Command Double-Clicking
  1034.  
  1035.  
  1036. In Bib mode, command double clicking does different things depending on the
  1037. current window type and on the context of the text being selected.  (Note
  1038. that in this section "clicking" is means command double-clicking.)  In all
  1039. Alpha modes, command double-clicking is also bound to the F6 key.
  1040.  
  1041.     In .bib files ...
  1042.  
  1043. Clicking on cross-references and strings will move the cursor to the
  1044. location of their original entry.  Clicking on defined abbreviations will
  1045. confirm that they exist as a mode preference.  (Strings, cross-references 
  1046. and abbreviations are not surrounded by delimiters during reformatting.)
  1047.  
  1048. Clicking on an entry name (such as "article", "book", etc) will perform a 
  1049. quick validation check of required fields, displaying the results in the 
  1050. status bar window.
  1051.  
  1052. Clicking on a field name will format the entire entry.
  1053.  
  1054. Holding down the control key while command double-clicking on any text 
  1055. with a field will perform a search of that term across the entire window, 
  1056. displaying the results in a new window.
  1057.  
  1058. Similarly, holding down the shift key while clicking will search for that
  1059. term across the entire window, but limited to the field in which that term
  1060. is currently contained.  (For example, shift-clicking on "DiMaggio" in the
  1061. author field will display all entries where he is listed as an author.
  1062.  
  1063.     In Results windows ...
  1064.  
  1065. Clicking on cite-keys will bring the file in which they were defined to 
  1066. the front, opening the file if necessary.  (If the file is closed, Alpha 
  1067. relies on the "BibTeX Files" list to find it.)
  1068.  
  1069.     In View Bib Acronyms windows ...
  1070.  
  1071. Clicking on an acronym allows you to re-define it.
  1072.  
  1073.  
  1074.           Adding New Entries
  1075.  
  1076.  
  1077. Entries can be added to Bib mode's menu in two ways.  The first is to
  1078. simply use the "Entries --> Custom Entry" menu item.  This will prompt you
  1079. for the default fields for your new entry, and make it available as an
  1080. electric completion.  Use the "Default Entry Fields" menu to edit (or
  1081. remove) any custom entries.
  1082.  
  1083. Using this method will not, however, make the entry available for
  1084. validation, because none of its fields have been designated as either
  1085. "required" or "optional".  To teach Bib mode a new entry for validation
  1086. purposes, it should instead be defined in a "BibPrefs.tcl" file.  It should
  1087. include the following Tcl code:
  1088.  
  1089.     set   rqdFld(myEntry) "field1 field2 etc"
  1090.     set   optFld(myEntry) "field3 field4 etc"
  1091.     
  1092.     Bib::updateMyFld
  1093.  
  1094. Each line is important, and should be written exactly as it appears above.
  1095. Here's an example:
  1096.  
  1097.     set   rqdFld(webPage) "author url date"
  1098.     set   optFld(webPage) "organization"
  1099.     
  1100.     Bib::updateMyFld
  1101.  
  1102. In this case you would probably also want to add "url" and "date" to the
  1103. "Add Fields" preference.  Important: this means that "myEntry" should NOT
  1104. be defined using the "Custom Entry" menu item !!!  If it has already been
  1105. defined this way, the "Default Entry Fields --> Remove Custom Entry" menu
  1106. item will allow you to delete it.
  1107.  
  1108. After adding this code to the BibPrefs.tcl file, load the file using the
  1109. menu item "Mode Prefs --> Load Prefs File".  Your custom entry should then
  1110. be listed in the "Entries" menu, available as an electric completion, and
  1111. subject to field validation.  This file will be sourced automatically upon
  1112. every subsequent restart of Alpha.
  1113.  
  1114. (If you think that an additional entry should be included in the next Bib
  1115. mode distribution, be sure to send it to the mode's maintainer !)
  1116.  
  1117.  
  1118.     ======================================================================
  1119.  
  1120.  
  1121.           Conversions
  1122.  
  1123.  
  1124. Alpha has a few BibTeX file conversion functions available in the
  1125. BibTeX menu, which are turned on by default.  They include:
  1126.  
  1127.  
  1128.                Bib To Html
  1129.  
  1130.  
  1131. Pierre Basso    <basso@lim.univ-mrs.fr>
  1132.  
  1133. package: bibToHtml
  1134.  
  1135. Bib To Html will convert either an entire bib file or only a selected
  1136. (highlighted) portion.  All the bib entries will be analyzed and converted
  1137. in a html bibliographic reference.  If you convert a file 'fooname.bib'
  1138. you'll get a file 'fooname.html' in the same folder.
  1139.  
  1140. When Bib To Html ends, it prompts the user to direct send the html file to
  1141. the browser, else it displays this file as a front window.  You may improve
  1142. this html file, in adding titles, figures or any fancies, for example,
  1143. before sending it to the browser.
  1144.  
  1145. Before this conversion the bib file can be sorted by the "Sort by" menu item.
  1146.  
  1147. Important: This procedure requires working on correct bib files, i.e.
  1148. devoid of any syntactical bibtex error.
  1149.  
  1150.  
  1151.                Bib To Refer (EndNote)
  1152.  
  1153.  
  1154. Peter Blattner    <peter.blattner@imt.unine.ch>
  1155.  
  1156. package: bibToRefer
  1157.  
  1158. Conversion of BibTeX to Refer (Endnote compatible).  If there are several
  1159. authors, each author has its own tag %A.
  1160.  
  1161. It might be necessary to run the "Convert LaTeX to Accent" utility first,
  1162. and eventually the "Format All Entries" menu item.
  1163.  
  1164. Important: "@string"s are not handled, and if they are present the
  1165. procedure will die without any warning.
  1166.  
  1167.  
  1168.                Bib Convert
  1169.  
  1170.  
  1171. Vince Darley    <vince@santafe.edu>
  1172.  
  1173. package: bibConvert
  1174.  
  1175. First attempt at parsing various records into bibtex entries.  It now copes
  1176. with hollis records, the horrible form of inspec record our firstsearch
  1177. interface gives us, and a nicer form of inspec record produced by another
  1178. interface.
  1179.  
  1180. Open a '.hollis' or '.inspec' file and Alpha automatically switches to
  1181. bibtex mode.  Select the bibtex menu item 'Bib Convert', also bound to the
  1182. key combination '<ctrl>-b', and Alpha converts the open window, saving it
  1183. in a new file (with extension '.bib'), which it then opens for you to
  1184. examine!
  1185.  
  1186. See also the notes contained in package: bibConvert and "bibConvert.tcl".
  1187.  
  1188. An example .hollis file, "Hollis-Example.hollis" is also included in the
  1189. Mode Examples folder.
  1190.  
  1191.  
  1192.     ======================================================================
  1193.  
  1194.  
  1195.           BibTeX Application
  1196.  
  1197.  
  1198. You'll probably want either Vince's Macintosh port of BibTeX (available
  1199. with OzTeX, or at <http://www.santafe.edu/~vince>) which allows a lot of
  1200. cool command-clicking in a log window to leap to errors/warnings in your
  1201. .bib files, or you may want to use the version with CMacTeX (shareware).
  1202.  
  1203. The original Unix version is by Oren Patashnik: BibTeX 0.99c .
  1204.  
  1205.  
  1206. If you are using a Macintosh BibTeX application, then you should take
  1207. advantage of the package: bibtexEngine, a global feature.
  1208.  
  1209. As Vince describes it:
  1210.  
  1211. When you command click on warnings, errors and filenames in the BibTeX log
  1212. window, BibTeX sends a particular kind of apple-event to your 'bibresult'
  1213. helper application.  This file contains procedures for the editor Alpha
  1214. which allows it to receive and interpret those messages in a useful way.
  1215. It's a huge time-saver, I guarantee!
  1216.  
  1217. To use this feature, you must also open Internet Config, select 'helpers'
  1218. and add a helper for 'bibresult', and select as helper the application
  1219. 'Alpha'.
  1220.  
  1221. For the technically minded: I use Internet Config to do the dirty work
  1222. of sending apple-events for me.  One day I'll write my own code, but this
  1223. hack works quite well for the moment.)
  1224.  
  1225.  
  1226.           BibTeX Mode History
  1227.  
  1228.  
  1229. This package was inspired by LaTeX support package (latex.tcl), written by
  1230.  
  1231.     Tom Scavo          <trscavo@syr.edu>  , and (originally),
  1232.     Richard T. Austin  <austin@eecs.umich.edu>
  1233.  
  1234. The Bib mode was originally written by Tom Pollard in 1994.  Vince Darley
  1235. reworked the mode from 1997 to 1999.  Further suggestions were incorporated
  1236. by Craig Barton Upright in 2000 -- Vince said that the mode was currently
  1237. homeless, and Craig offered to be the mode's maintainer until someone else
  1238. steps forward.
  1239.  
  1240. The "bibVersionHistory.tcl" file contains a more complete version history.
  1241.  
  1242.  
  1243.           Future Directions
  1244.  
  1245.  
  1246. Bug reports, complaints and suggestions are very welcome.  Most of the
  1247. improvements and bug fixes made since the last major release (2.0) were
  1248. the result of reports and suggestions from users.
  1249.  
  1250. Version 3.6 introduced a lot of changes, and there are sure to be a few
  1251. bugs somewhere.  Reports should be directed to the current maintainer:
  1252.  
  1253.          Craig Barton Upright  <cupright@princeton.edu>
  1254.  
  1255. or submitted to the ALPHA-D mailing list.
  1256.  
  1257. This is a mailing list for Alpha where you can discuss problems, suggest new
  1258. features etc.  To subscribe, email <listserv@listserv.syr.edu> and, in the
  1259. body of your message (not the subject line), write:
  1260.  
  1261.     SUBSCRIBE ALPHA-D
  1262.  
  1263.  
  1264. These are some of the ideas that Vince is considering for future enhancements
  1265. to the BibTeX support package (roughly in the order they are likely to be
  1266. addressed).  We welcome any comments or additional ideas people may have.
  1267.  
  1268. 1.  Speed up entry reformatting.  (Not as troubling with the newer Macs,
  1269.     and should be considerably faster in Alpha 8.)
  1270.  
  1271. 2.  Allowing more complicated searches.  Logical 'AND' searches can be
  1272.     done now by doing additional searches on the results of previous ones.
  1273.     It would be nice to allow logical 'OR' searches by concatenating the
  1274.     results of successive searches to a database in the same buffer.  Ideas
  1275.     for simple, intuitive ways to control this would be welcome.
  1276.  
  1277.     (Note -- I've changed the behavior of "Search Results"  since Vince
  1278.     wrote this.  Do the current options meet users' needs ??  -- cbu )
  1279.  
  1280. 3.  Since the code parses BibTeX entries already, it would be easy to
  1281.     export .bib files to other formats beyond Refer and Html, but I'm not
  1282.     sure if it's a good idea to start burdening Alpha with that sort of
  1283.     thing.  Writing Perl scripts for file conversions is probably a better
  1284.     idea.  See, for instance, the CC to BibTeX Perl script (included in the
  1285.     :Tcl:Packages:Text Filters folder), which converts citations from the
  1286.     on-line Current Contents database (the one at UC Berkeley, anyway) to
  1287.     BibTeX format.
  1288.  
  1289. Craig's list:
  1290.  
  1291. 1.  It would be nice to somehow recognize remote files in the Bib Files
  1292.     list.  I can imagine a preference for "Use Remote Paths", and then some
  1293.     menu items similar to mode search paths to select them.  This should
  1294.     probably be incorporated into the package: modeSearchPaths, rather than
  1295.     being specific Bib mode procedures.  If this were added, I would
  1296.     probably set the preference to "0" every time the mode is initially
  1297.     loaded so that we don't call the ftp helper unless we make a conscious
  1298.     decision.  
  1299.  
  1300.     (Selecting the preference in the "Bib Mode Files" menu would then call
  1301.     the helper, and rebuild the list -- the actual paths would be saved
  1302.     between sessions.)
  1303.  
  1304. 2.  The current manipulation and storage of cite key lists probably isn't
  1305.     so very efficient, and perhaps they should simply be stored in a cache
  1306.     somewhere.  The current solutions work, but slow down considerably
  1307.     when the list gets very large (say more than 750 entries or so.)
  1308.  
  1309.  
  1310.           License and Disclaimer
  1311.  
  1312.  
  1313. Copyright (c) 2000  Tom Pollard, Vince Darley, Craig Barton Upright
  1314. All rights reserved. 
  1315.        
  1316. Redistribution and use in source and binary forms, with or without
  1317. modification, are permitted provided that the following conditions are met:
  1318.  
  1319. Redistributions of source code must retain the above copyright notice, this
  1320. list of conditions and the following disclaimer.
  1321.  
  1322. Redistributions in binary form must reproduce the above copyright notice,
  1323. this list of conditions and the following disclaimer in the documentation
  1324. and/or other materials provided with the distribution.
  1325.  
  1326. This software is provided by the copyright holders and contributors "as is"
  1327. and any express or implied warranties, including, but not limited to, the
  1328. implied warranties of merchantability and fitness for a particular purpose
  1329. are disclaimed.  In no event shall the regents or contributors be liable
  1330. for any direct, indirect, incidental, special, exemplary, or consequential
  1331. damages (including, but not limited to, procurement of substitute goods or
  1332. services; loss of use, data, or profits; or business interruption) however
  1333. caused and on any theory of liability, whether in contract, strict
  1334. liability, or tort (including negligence or otherwise) arising in any way
  1335. out of the use of this software, even if advised of the possibility of such
  1336. damage.
  1337.  
  1338. This mode is free.  Alpha is shareware ! <<register>>
  1339.  
  1340.  
  1341. cheers,
  1342.  
  1343. -- Craig
  1344.  
  1345.  
  1346. Help Authors:  Tom Pollard, Vince Darley, Craig Barton Upright
  1347.  
  1348.    Maintainer:  Craig Barton Upright
  1349.        E-mail:  <cupright@princeton.edu>
  1350.          mail:  Princeton University,  Department of Sociology
  1351.                 Princeton, New Jersey  08544
  1352.           www:  <http://www.princeton.edu/~cupright/>
  1353.